home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 033a / wafsrtr2.zip / FILESORT.DOC next >
Text File  |  1991-10-21  |  8KB  |  147 lines
  1. FILESORT.EXE   (10/20/91)  by Brad Brown      (6/8/91)
  2. MS-DOS WAFFLE (512k mem)
  3.  
  4. Version 2.0
  5.  
  6. Well!  Quite a bit has changed since the release of version 1.0... the
  7. first (and most significant) change is the ability to run this from remote
  8. as well as the local console. See below for more details...
  9.  
  10.                                 Introduction
  11.                                 ------------
  12.  
  13. Basically, in a nutshell, our problem was this.  We run a WAFFLE node down
  14. in the San Diego area with a hefty download section, and trying to maintain
  15. the @FILES description file with a text editor was a pain in the butt...so...
  16. I came up with this little utility program to help in the maintenance of
  17. the description file.  It has imbedded utilities to view GIF files (using
  18. your favorite viewer program... I happen to like VPIC), and also the ability
  19. to view text files (using the internal lister or an external program/editor
  20. such as Vernon Buerg's excellent LIST.COM program).
  21.  
  22. New for 2.0...
  23.  
  24.   1 - Remote usage.  For those of you familiar with version 1.0, the
  25.       program lacked the ability to be run from anywhere but the local
  26.       console.  This is due to something within Turbo Pascal that I couldn't
  27.       figure out (yes, I tried DIRECTVIDEO=FALSE... but it still wouldn't
  28.       work...).  So, with this version, and the help of a few comm
  29.       routines, you can now use this program from remote.
  30.  
  31.   2 - Fixed bugs.  A comment was made about the \ to / conversion only
  32.       working with CD, and not with any other command (like MOVE)... well,
  33.       I've fixed it so that the conversion will work with all commands.
  34.       Also, there was a bug that allowed you to use the MOVE command on
  35.       a directory (with indeterminate results...)  That was removed.
  36.       The EDIT command has been fixed to only allow 44 chars in
  37.       the description.. rather than just truncating the line down to
  38.       44... (or was it re-prompting for the new description??).
  39.       Also, a few folks asked for the program to start up in the current
  40.       directory, rather than the top directory in the STATIC file...
  41.       Ok... I fixed that too.  Lastly, there was a bug where you could
  42.       use the TYPE command with EXE or COM files... this was bad.  I
  43.       have set an error trap to check the files for any illegal characters,
  44.       and will abort the listing automatically if it finds any.
  45.  
  46.   3 - New features.  The DIR command is now much more versatile... and
  47.       much more like the dos DIR command.  Screen pausing is no longer
  48.       automatic (in DIR requests, that is... the TYPE command still does
  49.       auto pausing), so you'll need to add the /p switch in your DIR
  50.       requests. Also, limited wildcards and filenames are allowed (similar
  51.       to the MS-DOS DIR command.)  By limited, I mean *.ext or filespec.*.
  52.       I tried writing the code for the true * or ? wildcard searches, but
  53.       after two nights of headaches, I gave up and left it where it is.
  54.       If anyone has a cute piece of TPas5.5 code to do this, e-mail
  55.       it to me... Lastly, the /w command for wide directory is now
  56.       supported.
  57.  
  58.       The use or ^S/^Q for the XON/XOFF protocol (screen pausing) is now
  59.       supported, as well as being to abort listings using any of the
  60.       SPACE, ESC, or ^C keys.
  61.  
  62.  
  63. As for how to use the program, just remember that either ? or HELP will
  64. get assistance from anywhere within the program (well, almost anywhere).
  65. So, for the most part, what ya see is what ya get.  So just play around,
  66. you should figure it out REAL quickly (hell, if you figured out how to
  67. set up WAFFLE... this should be a cinch!).
  68.  
  69. Just a couple of notes for installation purposes...
  70.  
  71. 1st -> You need to put a text file called FILESORT in your EXTERN directory
  72.        (i.e. COPY CON FILESORT)).  Use an entry similar to this...
  73.  
  74.         /priv=9 /local /command="D:\WAFFLE\BIN\FILESORT.EXE %d"
  75.  
  76. If you ever need to run FILESORT from the command line, you need to add
  77. the extention LOCAL (or local, or -l) to the filename (i.e. FILESORT LOCAL)
  78. in order to keep the modem from kicking on...
  79.  
  80. 2nd -> If you want to use the GIF viewing function of FILESORT, you'll need
  81. to add the line "VIEWER  : <path>" to your STATIC file.  Include the
  82. full pathname to the viewer program you wish to use.  Also, if you'd rather
  83. use an external text reader/editor program (rather than my incredible version
  84. of DOS - "TYPE <filespec> | MORE" command), add the line "READER  :  <path>"
  85. to the STATIC file as well...(omit the quotes...)  In addition, you can also
  86. specify any switches to pass to those programs after the path to the program
  87. (i.e.  VIEWER : C:\UTIL\VPIC\VPIC.EXE /v  .. the /v is now needed with the
  88. newer versions of VPIC in order to do auto size detection...).  Please note,
  89. the external reader/pic-viewer functions are available only when running
  90. FILESORT in local mode (for fairly obvious reasons..).
  91.  
  92. 3rd -> On systems (especially XT's), don't try to run the GIF viewing function
  93. from within the program IF you run FILESORT out of the WAFFLE shell.  XT's
  94. just don't have the upper memory to handle the larger GIF's, and your system
  95. might hang... Then again, our betatest machine was running on an OAK VGA
  96. card...
  97.  
  98. 4th -> The CD command works much the same as the DOS counterpart, with one
  99. exception... You can specify a drive as well as a path that you
  100. want to change to (i.e.   CD c:\waffle\bin  or  CD d:\public\ibm).. the
  101. \ or / are ambigious to FILESORT (either will work...).
  102.  
  103.  
  104. That's about it.  I've got a few more features I'd like to add to it (such
  105. as sorted directories and the like), but those will (or perhaps may...) be
  106. available in the next release... ( 3.0???  I dunno...).
  107.  
  108. A note to FOSSIL driver users... One problem I've noticed is that the program
  109. is not well behaved when using a FOSSIL type driver (X00, BNU, etc.)  I
  110. haven't personally been able to play around with FILESORT when a FOSSIL is
  111. installed (do I really need one at 2400 baud?!?!), so, you might need to run
  112. FILESORT out of a batch file that first turns off the FOSSIL (I know this
  113. is possible with the BNU driver, as for X00... beats me!), then run
  114. FILESORT... upon exit, it should then restart the FOSSIL before exiting
  115. back to WAFFLE.  As I said, I haven't tried this personally, but theoretically
  116. it should work... that is, if when you disconnect the FOSSIL, it really
  117. disconnects.  If someone has any hints on how to disconnect it from within
  118. a Turbo Pascal program, I'd sure be happy to listen!!
  119.  
  120. If you have any comments/suggestions/feedback/bug reports/etc. please send
  121. them to   bbrown@ziggys.cts.com.   Be gentle though... I don't program for
  122. a living, and the source for this thing (if you were ever to see it) would
  123. prove it!
  124.  
  125. One last thing... This program was originally released as freeware... it
  126. cost me nothing to put it out (a little time and foul language not
  127. withstanding...), however, the routines to run the modem did cost a few
  128. pennies (about 3500 pennies to be exact), so if you like FILESORT (or even
  129. don't like it!) and are feeling a little generous, drop a few bucks in the
  130. mail to me... I'd sure appreciate it (starving student on this end...).
  131.  
  132.   Send to:
  133.  
  134.      Brad Brown
  135.      12177 Avenida Consentido
  136.      San Diego, CA  92128
  137.  
  138.  
  139.  
  140.                                           -Brad Brown (courier)
  141.                                           Ziggy's - The Den of Iniquity
  142.                                             619/262-6384
  143.  
  144. P.S. I'd like to thank the dedicated (dedicated?) following of folks that
  145. use this program and who sent me their comments and suggestions.  You make
  146. the effort worthwhile.
  147.